home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 1 / Assassins - Ultimate CD Games Collection (1994)(Weird Science)(Track 1 of 2)[!][Amiga-CD32-CDTV][CDD5332].iso / instructions / board / quinzee < prev    next >
Text File  |  1994-01-01  |  12KB  |  282 lines

  1. +Introduction+
  2. --------------
  3. This is Quinzee 1.0, by Chris Bailey.
  4.  
  5. Quinzee (pronounced 'Quincy') was written because I wanted a fairly 
  6. addictive game that would run from the hard drive, run in high resolution, 
  7. and keep a dated high score table.  Quinzee is based on YACHT-Z! by Bob 
  8. Dolan, a program that runs under Microsoft Windows, but (in my opinion) 
  9. Quinzee is a bit flashier and has a few more options.
  10.  
  11. +Installation+
  12. --------------
  13. To install Quinzee on your system, simply drag the Quinzee icon
  14. to the directory/drawer of your choice.  If you would like on-line help
  15. available while playing the game, drag the Quinzee.guide icon either to
  16. the same directory or place it in any directory contained in your
  17. amigaguide/paths environment variable.  (Consult the documentation for
  18. AmigaGuide® for information on how to set this variable)
  19.  
  20. While running, Quinzee will create a high score table in the same 
  21. directory as the main program.
  22.  
  23. +How To Play+
  24. -------------
  25. After your name has been entered, the game is ready to be played.  
  26. Quinzee works like most games of this type, with the following rules :
  27.  
  28.   · You may take up to three dice rolls to complete a turn.
  29.   
  30.   · You may select which dice to roll and which dice to keep by clicking
  31.     on the dice with the left mouse button.  Dice that you wish to keep
  32.     will have the word "Hold" written beneath them, and dice that will be
  33.     rolled will not.
  34.   
  35.   · A turn is complete when you have selected an appropriate score for 
  36.     the dice that are displayed.  "Good" scores will be highlighted in
  37.     boldfaced text and a brighter colour than the other scores.  If a
  38.     score is not highlighted, you will receive 0 points for selecting
  39.     that score.
  40.  
  41.   · The game is complete when you have filled in the entire score card.
  42.  
  43. +Menu Items+
  44. ------------
  45. New Game 
  46.  
  47.   Starts a new game from scratch, clearing the current score.
  48.  
  49. Set Player 
  50.  
  51.   Sets the current player name.  The player name is only used for the
  52.   purpose of the high score table.  You may change your name during a game
  53.   with no ill-effects.
  54.  
  55. Undo Score
  56.  
  57.   This menu item is only available after you have picked a score for
  58.   a set of dice.  If you change your mind after selecting a score
  59.   (or perhaps you just hit the wrong button), you can undo your
  60.   selection using this menu item and pick another score.  One
  61.   important note - if you have rolled twice, pick a score and then
  62.   undo that score, you cannot roll again.  This is intentional.
  63.  
  64. Colours >>
  65.  
  66.   This menu item leads to ten sub-items, each of which is a different
  67.   colour scheme for Quinzee.  When you exit Quinzee, the currently 
  68.   selected colour scheme will be saved along with the high score table 
  69.   and will remain in effect the next time you run the program.
  70.  
  71. About
  72.  
  73.   Displays some version information in a window along with the author's
  74.   name and some very large dice.  Select the "Okay" gadget or press a key
  75.   on the keyboard to continue.
  76.  
  77. Quit
  78.  
  79.   Saves the high scores and current colour scheme, then exits *immediately*
  80.   with no confirmation.
  81.  
  82. +The High Score Table+
  83. ----------------------
  84. High scores are saved to the file "Quinzee.scores" in the same directory
  85. as the main program.  They are saved whenever a new score is achieved and
  86. when exiting the program.  If you tie a high score you will be placed
  87. ahead of the score that you tied.
  88.  
  89. If you wish to clear the high score table, simply delete the
  90. "Quinzee.scores" file and a new one will be generated.
  91.  
  92. Our highest score to date is 2434 points.  Can you beat this? 
  93.  
  94. +On-line Help+
  95. --------------
  96. If you install the "Quinzee.guide" file that came with this 
  97. distribution into the same directory as Quinzee, you can have help
  98. available at any time, provided you have AmigaGuide installed in your
  99. system.  To obtain help press the HELP key either while at the main play
  100. screen or while selecting menus.
  101.  
  102. The help file is generated by an ARexx script from the documentation, so
  103. both files contain roughly the same information.
  104.  
  105. +Scoring+
  106. ---------
  107. Scoring follows the standard scoring for a certain copyrighted game that you
  108. may or may not be familiar with.  The grand total, however, comes from the 
  109. grand total for the first column plus double the grand total of the second 
  110. column plus the triple the grand total of the third column.
  111.  
  112. Standard scoring for each item is as follows :
  113.  
  114.   Ones           : The total of all Ones showing on the dice.
  115.   Twos           : The total of all Twos showing on the dice.
  116.   Threes         : The total of all Threes showing on the dice.
  117.   Fours          : The total of all Fours showing on the dice.
  118.   Fives          : The total of all Fives showing on the dice.
  119.   Sixes          : The total of all Sixes showing on the dice.
  120.   Total          : Calculated by adding the totals of all Ones
  121.                    through all Sixes.
  122.   Bonus          : If your Total is 63 points or over (see notes below),
  123.                    you get a score of 35, otherwise 0.
  124.   Upper Total    : The sum of Total plus Bonus.
  125.   
  126.   3 of a Kind    : The total of all 5 dice or 0 if you don't have Three
  127.                    of a Kind.
  128.   4 of a Kind    : The total of all 5 dice or 0 if you don't have Four 
  129.                    of a Kind.
  130.   Full House     : 25 Points if you have a Full House, otherwise 0.
  131.   Small Straight : 30 Points if you have a Small Straight, otherwise 0.
  132.   Large Straight : 40 Points if you have a Large Straight, otherwise 0.
  133.   Quinzee        : 50 Points if you have a Quinzee (5 of a kind), 
  134.                    otherwise 0.
  135.   Chance         : The total of all 5 dice.
  136.   Quinzee Bonus  : 100 Points each, filled in from left to right for each
  137.                    Quinzee Bonus you receive. 
  138.                    (See "How To Get A Quinzee Bonus")
  139.   Lower Total    : The total of the previous 8 items.
  140.   
  141.   Upper + Lower  : The Upper Total plus the Lower Total.
  142.   Triple Quinzee : For the first column, the Upper Total plus the Lower
  143.                    Total.  (same as Upper + Lower)  For the second 
  144.                    column, twice the Upper and Lower total of that column,
  145.                    and for the third column, three times the Upper and
  146.                    Lower total of that column.
  147.   Grand Total    : The sum of the three "Triple Quinzee" totals.
  148.  
  149. +Scoring Hints+
  150. ---------------
  151. The Bonus in the upper section can be achieved by getting a minimum of
  152. three of a kind in each of the Ones through Sixes score boxes. 
  153.  
  154. Because the totals are multiplied by three in the third column, it makes
  155. sense to score certain columns from right to left.  For example, you
  156. should almost always score Quinzees in the third column first since you
  157. may not get another two Quinzees during the game.  The same goes for
  158. items like Small Straight, Large Straight and Full House where you get a
  159. fixed score for that column.
  160.  
  161. +How To Get A Quinzee Bonus+
  162. ----------------------------
  163. First, you have to get three Quinzees (5 of a kind).  This is more difficult 
  164. than it sounds.  
  165.  
  166. Now, assume you have received three Quinzees, they are all scored in the
  167. correct box, and you roll another Quinzee.  You will get a Quinzee Bonus
  168. if and *only* if you score that Quinzee in a valid box.  This isn't
  169. terribly hard to do unless you are toward the end of the game and only
  170. have items like Small Straight and Large Straight left. 
  171.  
  172. +Public Screen Operation+
  173. -------------------------
  174. Quinzee runs on a public screen!  You can use any program that opens on a 
  175. public screen in conjunction with Quinzee.  The public screen name is
  176. "QUINZEE", so to run the Clock from Workbench on Quinzee's screen :
  177.  
  178.   RUN <NIL: Clock PUBSCREEN QUINZEE
  179.   
  180. Voila!  Now you can watch the hours pass away while playing Quinzee.
  181.  
  182. +Distribution+
  183. --------------
  184. I hereby declare this piece of software copyright, but freely 
  185. distributable.  You may give copies of this program to your friends
  186. and put it on public bulletin boards and networks provided you do not
  187. try to make money from it.
  188.  
  189. Express permission is granted for Fred Fish to include this program in
  190. his library of freely distributable software.  Other disk collections
  191. may include this program provided they do *not* charge more per disk than
  192. Fred Fish charges for his.
  193.  
  194. And please, if you are distributing this program, please be sure to 
  195. include the entire original archive.  
  196.  
  197. +Technical Information+
  198. -----------------------
  199. If technical information scares you, skip reading this section.
  200.  
  201. Total lines of source code : 5003
  202. Total source files         : 20
  203. Total bytes of source code : 159011
  204.  
  205. The main body of code was written in the space of three days, with the
  206. rest of the job stretched out over a period of two months or so.
  207. The remaining days were used for optimization, bug hunting, and
  208. documentation construction.
  209.  
  210. This program was written using the M2Sprint Modula-2 compiler.  In
  211. addition, my very own AmigaDOS 3.0 definition modules were used.  If you
  212. are interested in purchasing these, please contact me via E-mail at one
  213. of the addresses at the end of this document.
  214.  
  215. All editing of text was done using the wonderful TurboText.
  216.  
  217. Three private custom Boopsi classes were created for this program :
  218.  
  219.   ButtonClass - A standard intuition-like button gadget with a fillable 
  220.   interior and rounded edges.
  221.     
  222.   ScoreButtonClass - Another intuition-like button gadget that accepts 
  223.   an integer for the label and becomes outlined when disabled.
  224.     
  225.   DiceClass - A scaleable gadget with dice imagery that displays the
  226.   word "hold" below it when selected.
  227.  
  228. Much of the work involved in writing this program came in the form of
  229. laying out the screen.  The layout has the following features that may
  230. not be immediately evident when running the program :
  231.  
  232.   · The dice gadgets scale according the the aspect ratio of the display
  233.     mode used, so they will appear to be (more or less, depending on how
  234.     you have your monitor adjusted) square on both PAL and NTSC modes.
  235.     
  236.   · Everything on the screen expands or contracts slightly to accomodate
  237.     any vertical and/or horizontal overscan you might have.  This means
  238.     that the screen looks natural in both PAL and NTSC modes.
  239.   
  240.   · If the screen font for the Workbench screen matches what this 
  241.     program needs to run, it will get used.  Currently this means that
  242.     the font be sized 11 or have an 11-sized equivalent, and it cannot
  243.     be proportional.  If the Workbench screen font doesn't match this,
  244.     topaz 11 is used.
  245.  
  246. +Special Thanks+
  247. ----------------
  248. Special thanks must go to :
  249.  
  250.   Everyone on BIX who suggested names for the program to avoid using
  251.   the obvious, copyrighted name.  (Even though I didn't use any of the
  252.   suggestions)
  253.   
  254.   Martin Taillefer for testing Quinzee on the latest hardware.
  255.   
  256.   Marianne Rodwell for proof reading, play testing, colour palettes, 
  257.   and many many suggestions.
  258.  
  259. +Registration+
  260. --------------
  261. There is no fee implied or charged for using Quinzee, although if you
  262. feel inclined to encourage the author to develop more programs like
  263. this, a donation of $10 US will not be refused.  See "Contacting The
  264. Author" for the address to send your donation to.  Although I am
  265. currently living in Australia, donations sent to the address
  266. shown will reach me eventually.
  267.  
  268. +Contacting The Author+
  269. -----------------------
  270. I may currently be contacted via e-mail at the following places :
  271.  
  272. BIX      : csbailey
  273. Internet : csbailey@bix.com
  274.  
  275. If you wish to support a starving developer, donations should be sent to:
  276.  
  277. Chris Bailey
  278. c/o DataPlex Corporation
  279. 1700 Sunset Boulevard, Suite 5
  280. West Columbia, SC  29169
  281. (USA)
  282.